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1. SCOPE 


I 


i 

This document specifies design of the monthly weather and yield data ^ 

bases for Brazil and China, following the same design as those pre- 
viously documented for Australia, Canada, the U.S., and the U.S.S.R. 

In the "As-Bullt Design Specification for the Yield Estimation Subsystem j 

(YES) Monthly Yield Data Base and Supporting Programs" (JSC-12537/ j 

LEG- 10034). 



2. APPLICABLE DOCUMENTS 


o Action Documentation 63-1347-4963-10 


o "As-Bullt" Design Specification for the Yield Estimation Subsystem 

(YES) Monthly Data Base and Supporting Programs" (JSC-12537/LEC-10034) . 




3. SYSTEM DESCRIPTION 


3.1 HARDWARE DESCRIPTION 


These data, and supporting programs previously documented in "As-Built 
Design Specification" (JSC-12537/LEC-10034) , are resident on the 
IBM 360/195 complex at Suitland, Maryland. They should be transferable 
to any IBM 360-370 series machine with sufficient disk to handle the 
data base and main memory to support the PL/I optimizing compiler. 


3.2 DATA BASE STRUCTURE 


The monthly weather and yield data base is a tree structure, with nodes, 
or levels, being the country, region, zone, strata and station. For the 
Brazil data base, only the first three levels are present; these 
represent Brazil, southern Brazil, and Brazilian states, respectively. 
The five level representations in the China data base are, respectively, 
China, major geographic regions, Chinese provinces, Chinese provinces 
(repeated, as no LACIE strata divisions of China exist at this time), 
and WMO stations. 


3.2.1 DATA BASE STORAGE REQUIREMENTS 

The data sets for Brazil and China were input to space reserved for 
the India data base, as all three data sets are relatively small and 
could easily fit into the 114 6440-byte blocks originally allocated 
to India. 


3.2.2 CONTROL AND DIRECTORY BLOCKS 

The format for the control and directory blocks follows that previously 
defined in "As-Built Design Specification." The control block for 
file INDIA was updated to Include both Brazil and China, and directory 
blocks for both countries were added to file INDIA. 

Listings of the control block and the directory blocks are found in 
Appendix A. 


3.2.3 DATA DESCRIPTORS AND DATA BLOCKS 

The format for the data descriptors and data blocks follows that 
previously defined in "As-Built Design Specification." 

Both weather and yield variables are stored at the zone level in both 
countries (Brazilian states and Chinese provinces) . Only weather 
variables are stored for the Chinese WMO stations. 


Descriptor structures are found in Appendix B. A listing of variable 
codes contained In the descriptors is found In Appendix C. 

3.2.4 MODEL DEFINITION BLOCK 

Structure Is provided to allow inclusion of model definitions. 


4 . OPERATION 


4.1 DATA BASE INITIALIZATION AND DEFINITION 


As the Brazil and China data bases were added to empty, previously 
initialized blocks of file INDIA, no further Initialization was 
necessary. Control block update, and directory and descriptor 
definitions were accomplished using YESMOOl and supporting subroutines 
from "As-Built Design Specification" (JSC-12537/LEC-10034) . 


4.2 DATA CONVERSION (BRAZIL ONLY) 


Data for Brazil located at CCEA in Columbia, Missouri, exist in formats 
different from that required for inclusion in the data base. A short 
PL/ I program was written to handle the conversions to the required 
format. 

Converted data were stored on a catalogued disk file, and transferred 
to file INDIA when all conversions were completed. 

The program listing and flowchart appear in Appendix D. 


4.3 DATA BASE LOADING 


Data for Brazil and China were loaded using the updating program 
UPDDATA, documented in "As-Built Design Specification." 


4.4 DATA BASE LISTING 

Listing of the control and directory blocks are accomplished using, 
respectively, YESLS02 and YESLS04, documented in "As-Built Design 
Specification." To list data, LISTJOB, also from "As-Built Design 
Specification," will have to be modified to accomodate data for 
Brazil and China. 
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APPENDIX B 

DESCRIPTOR STRUCTURES 


// 


BRAZIL DATA YEAR ENTRY 


There is a maximum of 32 years following the data descriptor entry 
for each region of Brazil; the data for two regions can be placed in 
each data block. Each year entry is 88 bytes long. 


DCL I BRAZIL, 

2 YEAR 
2 NXTYRREC 
2 NXTYRDISP 
2 FILLER 
2 MEANTEMP(12) 

2 PREGIP(12) 

2 HARVESTED (4) 

2 PRODUCTION (4) 


FIXED BIN (15,0), 
FIXED BIN (15,0), 
FIXED BTN(15,0), 
FIXED BIN (15,0), 
FIXED BIN (15,0), 
FIXED BIN (15,0), 
FIXED BIN (3 1,0), 
FIXED BIN (51,0); 


CHINA PROVINCE DATA YEAR ENTRY 

There is a maximum of 32 years following the data descriptor entry 
for each province of China; the data for two provinces can be placed 
in each data block. Each year entry is 88 bytes long. 


DCL 1 CHINAJPROV, 

2 YEAR 
2 NXTYRREC 
2 NXTYRDISP 
2 FILLER 
2 MEANTEMP(12) 

2 PRECIP(12) 

2 HARVESTED (4) 

2 PRODUCTION (4) 


FIXED BIN(15,0), 
FIXED BIN (15,0), 
FIXED BIN (15,0), 
FIXED BIN (15,0), 
FIXED BIN(15,,0), 
FIXED BIN U 5,0), 
FIXED BIN 01,0), 
FIXED BIN (3 1,0); 


CHINA WIIO-STATION DATA YEAR ENTRY 


There Is a maximum o£ 40 years following the data descriptor entry 
for the Chinese WMO stations; the data for two stations can be placed 
in each data block. Each year entry Is 56 bytes long. 


DCL 1 CHINA_WMO, 

2 YEAR 
2 NXTYRREC 
2 NXTYRDISP 
2 FILLER 
2 MEANTEMP(12) 
2 PRECIP(12) 


FIXED BIN(15,0), 
FIXED BIN (15,0), 
FIXED BIN(15,0), 
FIXED BIN(15,0), 
FIXED BIN (15,0), 
FIXED BIN(15,0h 



APPENDIX C 


VARIABLE CODES 


Meteorological Variables 


Precipitation 5 

Mean temperature 35 

Yield Variables 

Harvested 101 

Production 103 

Props 

Spring wheat 201 

Winter wheat 202 

Unit of measurement 

Millimeters 201 

Quintals 228 

Hectares 236 

Degrees Centigrade 241 

Others 

Monthly 26 

Year 61 

Pointer 90 

Record pointer 91 

Displacement pointer 92 

Filler 99 



APPENDIX D 


CONVERSION PROGRAM LISTING 
AND FLOWCHART 
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